home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / util / misc / deinstaller.lha / DeInstaller / DeInstaller.doc < prev    next >
Text File  |  1995-10-23  |  13KB  |  383 lines
  1.  
  2.              --------------------------------------------------
  3.  
  4.                           ╗╗╗ DeInstaller v1.1a ½½½
  5.                  "The only way to keep your harddisk clean!"
  6.  
  7.                     Beetware ⌐ 1994-1995 The Beet Research
  8.  
  9.                         written by Grzegorz Calkowski
  10.  
  11.       -----------------------------------------------------------------
  12.  
  13.  
  14. Disclaimer
  15. ----------
  16.  
  17.     The program executable and information above is provided "as is".  No
  18. representations or warranties are made with respect to the accuracy,
  19. reliability, performance, currentness, or operation of this software and
  20. information, and all use is at your own risk.  The author doesn't assume any
  21. responsibility or liability whatsoever with respect to your use of the
  22. program and information.
  23.  
  24.  
  25. Copying
  26. -------
  27.  
  28.     DeInstaller is published under "BeetWare" conception.  It's very special
  29. sort of GiftWare.  It means you should send a beet to the author (but not a
  30. rotten one!  8).  Well, if you run short on beets send a disk or a small
  31. donation or anything else.  (Have a hint:  a bottle of beer would be
  32. excellent...  :)
  33.  
  34. This program can be freely distributed under following conditions:
  35.  
  36.         1. Everything in this distribution must be kept together and
  37.            unaltered. Applies to:
  38.  
  39.            DeInstaller                    (the program itself)
  40.            DeInstaller.info               (its icon)
  41.            DeInstaller.doc                (plain-ascii doc)
  42.            DeInstaller.doc.info
  43.            DeInstaller.guide              (AmigaGuide«'ed doc)
  44.            DeInstaller.guide.info
  45.            MWB-Icons/DeInstaller.info     (program icon in MagicWB style :)
  46.            MWB-Icons/DeInstaller_alt.info (an alternate MWB icon)
  47.            MWB-Icons.info
  48.  
  49.         2. Copyright notices are not removed from executable and
  50.            documentation.
  51.  
  52.         3. No more than a nominal fee is charged to cover cost of magnetic
  53.            media.
  54.  
  55. DeInstaller is Copyright (C) 1994 The Beet Research. All rights reserved.
  56.  
  57. The program uses:
  58.  
  59.               MultiGUI Copyright (C) TBR (it's linked together with program
  60.                                           should be available as a shared
  61.                                           library soon... :-)
  62.  
  63.               ReqTools library Copyright (C) Nico Franτois.
  64.  
  65.  
  66. Introduction
  67. ------------
  68.  
  69.     Every time you tried to install to your system a complex program
  70. spreading its stuff all over your harddisk (fonts, libs, scripts, locales,
  71. prefs, ARexx scripts and other accompaning files) you wondered "How will I be
  72. able to restore previous state of my harddisk?".  How many times you removed
  73. a program you couldn't figure out what file belongs to?  How many times you
  74. found a file in deep nookes of harddisk and you said "WHAT THE HELL IS IT?"
  75. and finally you didn't delete it???  Well, no more...
  76.  
  77.     DeInstaller should be used during installation.  It looks for all write
  78. attempts (including creating subdirectories) and creates an AmigaDOS script
  79. which, when executed, will throw out all the mess the installer did.  It also
  80. looks for all overwrite attempts giving you possibility to backup existing
  81. files (extension '.old' will be added).
  82.  
  83.  
  84. Features
  85. --------
  86.  
  87.    o Ability to deinstall everything you've installed.  Doesn't matter what
  88.      you've used to install (orginal Installer by Commodore, other custom
  89.      installers, install scripts or even you did it by hand...  :)
  90.  
  91.    o Font-sensitive GUI, fully keyboard controlled, just Commodore's user
  92.      interface style guide compliant (maybe except locale, sorry). But...
  93.      not only.  I followed Nico Franτois standards, what means when you press
  94.      a key assigned to a gadget it will be visualised and you can cancel it by
  95.      pressing a SHIFT key.  Even more.  There is a keypress timeout (very
  96.      useful when your other hand holds a cake, cup of coffee, bottle of beer
  97.      or even a girlie ;-).
  98.  
  99.    o MultiGUI'ed what means internal multitasking.  It's not so usable in
  100.      such a program but, for example, while DeInstaller is tracing you can
  101.      execute a script.  Or even you can contemplate 20 "Abouts"
  102.      simultaneously. Moreover it gives you proper (one pixel lower)
  103.      underscore char even if you use the ugly topaz (another great Nico's
  104.      idea - but mine is smarter, if you use a proportional font, underscore
  105.      won't be placed too low...  :).
  106.  
  107.    o 100% legal (well, almost :) & 100% assembly code
  108.      (well, the last one is not really a feature, though >)
  109.  
  110.    o Thoroughly tested with Enforcer & Mungwall.
  111.  
  112.  
  113. Requirements
  114. ------------
  115.  
  116.     DeInstaller requires an Amiga (surprise?) with at least Kickstart
  117. 2.04 (NOTE:  tested only on 3.0/3.1!, sorry :).  It is completely
  118. useless without harddisk.  It has no special memory requirements,
  119. should run even on 0.5MB machines.
  120.  
  121.     DeInstaller requires reqtools.library V38+ installed in your LIBS:
  122. (it's included in this archive).
  123.  
  124.  
  125. Installation
  126. ------------
  127.  
  128.     Copy the main program file and its icon whatever you want.  There
  129. are supplied two alternate icons in MagicWB style (Thanks, Dixan :).
  130.  
  131.     Copy (if you haven't) reqtools.library to your LIBS:  directory.
  132.  
  133.  
  134.  
  135.  
  136. Usage from Shell
  137. ----------------
  138.  
  139.     Bad news...  Although DeInstaller can be launched from Shell no
  140. options can be specified (only when launching from Workbench - via
  141. tooltypes).  But don't cry - for your convenience DeInstaller
  142. automatically detaches from Shell.
  143.  
  144.  
  145. Usage from Workbench
  146. --------------------
  147.  
  148.     When launched from WB DeInstaller looks for following tooltypes:
  149.  
  150.  
  151.         SCRIPTDIR=<path>      Sets the default directory for generated
  152.                               "deinstall scripts". If not specified, S:
  153.                               will appear in "Script" gadget.
  154.  
  155.                               Examples:
  156.                                          SCRIPTDIR S:deinstall
  157.                                          SCRIPTDIR=WORKS:scripts
  158.  
  159.                                 
  160.         NOREQUESTCHOICE       Sets "ask" mode instead of "requestchoice"
  161.                               mode. By default DeInstaller generates
  162.                               scripts which use RequestChoice command. As
  163.                               it is not available up to 2.1 Kickstart
  164.                               specifying this tooltype forces it to
  165.                               generate script which use ask command instead.
  166.  
  167.  
  168. Program's gadgets
  169. -----------------
  170.  
  171.     The program window contains following gadgets:
  172.  
  173.  
  174.         Program             Specifies the name of a program to install and,
  175.                             indirectly, to deinstall. You can type here
  176.                             whatever you want, but it is wise to note here
  177.                             program name and version. Program name doesn't
  178.                             mean a script name!
  179.  
  180.         Script              Specifies the script name to generate.
  181.  
  182.         Req                 As above, but pops up a file requester. 
  183.  
  184.         Trace               Begins the tracing for "newcomers" on your
  185.                             harddisk. If you didn't specify the program
  186.                             name you are kindly informed about.
  187.  
  188.                             Message "DeInstaller on duty" should appear.
  189.  
  190.         Stop                Quite self-explanating... finishes the
  191.                             operation.
  192.  
  193.                             Then you get a deinstall script, executable from
  194.                             Shell or directly from DeInstaller using Launch
  195.                             gadget. (For your convenience it has the script
  196.                             bit set, so you can omit Execute command, when
  197.                             launching from Shell).
  198.  
  199.         Launch              Executes selected script(s). It's for people
  200.                             who really don't like shell :-).
  201.  
  202.         Delete              Delete selected file(s). It's intended for
  203.                             deleting deinstaller scripts but, of course,
  204.                             you can delete what you want with this.
  205.  
  206.         About               Well, what to say about...
  207.  
  208.         Quit                I bet you have seen something like this before,
  209.                             haven't you?
  210.  
  211.         There is also an information (read-only) gadget.  Shows current
  212.         program status (eg. info about caught files and dirs).
  213.  
  214.  
  215. Examplary usage
  216. ---------------
  217.  
  218.     I want to install program Mess-on-harddisk v8.71 which I've just
  219. pirated.  It occupies 7 floppies and I'm really afraid it can fill my
  220. drive with hundreds of "don't-know-what-the-hell-it-is-for" files.
  221.  
  222. So I...
  223.  
  224.      - start DeInstaller
  225.  
  226.      - type "Mess-on-hardisk v8.71" in the ╗Program½ gadget
  227.  
  228.      - press ╗Req½ gadget - it will bring you a file requester in
  229.        S: directory (by default) and then type filespec (example:
  230.        "S:deinstall/messonhd-remove") for the "deinstall script" to generate
  231.  
  232.      - press ╗Trace½ what brings the file requester
  233.        ("Deinstaller on duty" should appear)
  234.  
  235.        NOW, I INSTALL THE PROGRAM! (with installer, if supplied or by hand)
  236.  
  237.        (during the installation DeInstaller shows how many files and dirs
  238.        were created on my harddisk)  
  239.  
  240.      - press ╗Stop½ button when installation is done.
  241.  
  242.      - press ╗Quit½ to leave the program.
  243.  
  244.        Now I have program Mess-on-harddisk v8.71 installed.  It filled my
  245.        drive with hundreds of "don't-know-what-the-hell-it-is-for" files.
  246.        And as I've figured out that this program is completly useless I
  247.        want to flush all that stuff out of my precious harddisk space.
  248.  
  249.      - start DeInstaller again. 
  250.  
  251.      - press ╗Launch½ gadget - select the script (in this case it is
  252.        "S:deinstall/messonhd-remove")
  253.  
  254.      - confirm the deinstallation process!
  255.  
  256.      After some flashings of harddisk led the harddisk is as BEFORE!
  257.      ---------------------------------------------------------------
  258.  
  259.      So, now I can install program Mess-on-harddisk-bigger-than-ever-before
  260.      which fills my drive with even more hundreds of "still-don't-know-what-
  261.      the-hell-it-is-for" files. So I...
  262.  
  263.  
  264. To Do
  265. -----
  266.  
  267.    Well, in previous release (1.1) I enumerated here some things to add in
  268. future (BTW:  it was over half a year ago !).  Yeah, but I decided to not use
  269. assembler anymore (at least for utilities), so DeInstaller wouldn't be updated.
  270. Believe me, I haven't enough motivation to rewrite it in, for example, C.  And,
  271. to be honest, there are much more exciting projects on the way.
  272.  
  273.  
  274. Contacting the author
  275. ---------------------
  276.  
  277.     Any ideas, bug reports, donations, etc.  will be sincerely
  278. welcomed.  Just drop me a piece of paper.
  279.  
  280.     My addy:
  281.  
  282.                 Grzegorz Calkowski
  283.                 Rzedowice
  284.                 ul.Dobrodzienska 8
  285.                 42-780 Dobrodzien
  286.                 POLAND
  287.  
  288.         phone: +48(0)34-575875
  289.                 
  290.         E-mail: calkowsk@us.edu.pl
  291.  
  292. Always remember:
  293. ----------------
  294.  
  295.         Beeting is beliving...
  296.  
  297.         and Amiga is best computer ever!
  298.  
  299.  
  300.  
  301. Acknowledgements
  302. ----------------
  303.  
  304. Thanks should go to:
  305.  
  306.  - Michal Prochownik for really constructive help with writting this doc
  307.    and for those awfully pretty icons.
  308.  
  309.  - my brand new A4000 which seems to be faaaar more reliable than the
  310.    damned A1200 I had before (and at least it looks faaaar better...:^).
  311.  
  312.  - Commodore for resurrection...
  313.  
  314.  
  315. Any greetings expected?  Well, press some keys in the program window... 8)
  316.  
  317.  
  318.                            PROGRAM HISTORY:
  319.  
  320.  
  321. v1.0▀ (16.10.94)
  322.  
  323.    o First BETA release.
  324.  
  325. ===========================================================================
  326.  
  327. v1.0 (25.10.94)
  328.  
  329.    o Ooopps... it worked only on my A4000 due to a damned bug causing an
  330.      Enforcer hit in MultiGUI stuff.
  331.  
  332.    o Another Enforcer hit found in CreateDir() patch. Fixed.
  333.  
  334.    o Some Mungwall hits found. Fixed.
  335.  
  336.    o Startup code was broken - DeInstaller crashed immediately when
  337.      launched from Shell. Fixed.
  338.  
  339.    o Small optimizations.
  340.  
  341. ===========================================================================
  342.  
  343. v1.1 (23.11.94)
  344.  
  345.    o AmigaGuide«'ed documentation included.
  346.  
  347.    o Important feature added: attempts to overwrite existing files are
  348.      intercepted - user can let overwrite, reject or backup existing
  349.      file (appends ".old" extension).
  350.  
  351.    o ╗Script½ and ╗Req½ gadgets added (instead of poping-up requester when
  352.      ╗Go½ was pressed..
  353.  
  354.    o New gadgets added: ╗Launch½ (allows to execute scripts), ╗Delete½
  355.      (allows to delete scripts)
  356.  
  357.    o ╗Go½ renamed to ╗Trace½.
  358.  
  359.    o Now window can be zipped (zoomed).
  360.  
  361.    o Version string was incorrect.
  362.  
  363.    o A plenty of internal optimizations.
  364.  
  365. ===========================================================================
  366.  
  367. v1.1a (09.07.95) <-- sic!
  368.  
  369.    o Some nasty mungwall hits found & cured.
  370.  
  371.    o Hope it will finally work on anything else than my A4000... ;]
  372.  
  373. ===========================================================================
  374.  
  375. (23.10.95)
  376.  
  377.    o Not really an update (no version change).
  378.  
  379.    o Reqtools.library removed from archive. Is there anybody without it?
  380.  
  381.    o Uploaded to Aminet (and my E-mail address included).
  382.  
  383.